home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / win / womenu25.zip / WOMENU.DOC < prev    next >
Text File  |  1995-01-19  |  37KB  |  919 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.                                    WOmenu
  20.                                    ══════
  21.  
  22.                           The Windows Office Menu
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.                       ▄▄▄▄▄▄▄▄▄▄▄
  38.                       █  ▄▄▄▄▄  █  (C)Copyright 1994-1995
  39.                       █  █   █  █
  40.                       █  ▀▀▀▀▀  ▀  Bremer Corporation
  41.                       █  ▄▄▄▄▄  ▄  Austin, Texas
  42.                       █  █   █  █
  43.                       █  ▀▀▀▀▀  █  All rights reserved
  44.                       ▀▀▀▀▀▀▀▀▀▀▀
  45.  
  46.  
  47.  
  48.  
  49.  
  50.                                  Version 2.5a
  51.  
  52.                                  January 1995
  53.                               TABLE OF CONTENTS
  54. ══════════════════════════════════════════════════════════════════════════════
  55.  
  56.      Topic                                                          Section
  57.  
  58.      Introduction ......................................................  3
  59.  
  60.      Miscellaneous .....................................................  4
  61.  
  62.      Quick Start .......................................................  5
  63.  
  64.      Commands ..........................................................  6
  65.  
  66.      WOmenu INI File ...................................................  7
  67.  
  68.      User Help INI FIle ................................................ 10
  69.  
  70.      Menu Rights ....................................................... 11
  71.  
  72.      Users Windows Environment.......................................... 14
  73.  
  74.      DOS Environment Variables ......................................... 15
  75.  
  76.      DOS Program PIF Files ............................................. 16
  77.  
  78.      Software Metering Service ......................................... 17
  79.  
  80.      WOmeter Windows Metering Utility .................................. 19
  81.  
  82.      DOSmenu Menu System ............................................... 20
  83.  
  84.      Shareware ......................................................... 21
  85.                                INTRODUCTION
  86. ══════════════════════════════════════════════════════════════════════════════
  87.  
  88. WOmenu was designed as a simple yet powerful menu system for both network and
  89. stand-alone environments where users must operate under Windows(tm).  Our
  90. environment demands a safe, secure menu to help our users run both DOS and
  91. Windows applications without allowing undo access to our large Texas-wide
  92. NetWare network.  The menu system we needed had to be both easy to use and
  93. flexible and yet it had to stay out of the way as much as possible for our
  94. user operations.  Because we could not find one, we wrote our own.  We hope it
  95. helps you control your Windows environment as well.  Please use WOmenu as you
  96. see fit, but if you continue to use it, you should register according to the
  97. SHAREWARE section below.
  98.  
  99.  
  100. Here is an example of why you might need WOmenu to help you out:
  101.  
  102. You have a network with one or more servers and many users.  Most of these
  103. users run a couple of business-specific apps and some utilities that you
  104. allow.  Now, you are finding that these users can be much more productive if
  105. they could run their one or two business apps at the same time while having
  106. their email and a utility or two instantly available.  This, of course, means
  107. multi-tasking, which probably means Windows.  But how do you keep all of those
  108. 'nice' things that Windows offers, like the File Manager and Write and
  109. Notepad, away from the users while defining a Program Group that makes sense
  110. to _each_ user?  Enter WOmenu...it was made to solve just that!
  111.  
  112.  
  113. Here is a quick overview of WOmenu:
  114.  
  115. o    Low resource utilization.
  116.  
  117. o    Flexible user-specific menus.
  118.  
  119. o    Unlimited menu items.
  120.  
  121. o    Unlimited sub-menus.
  122.  
  123. o    Run any program, DOS or Windows based.
  124.  
  125. o    Prevent multiple runs of the same program.
  126.  
  127. o    Easily operate the menu system without having to outfit users with mice.
  128.  
  129. o    Many rights options to determine whether a menu item is usable by a user.
  130.  
  131. o    Works great with NetWare and any other network operating system.  Also
  132.      works well as a stand-alone system.
  133.  
  134. o    All menu setup tasks handled through one INI file.
  135.  
  136. o    Complete user logging capabilities.
  137.  
  138. o    Complete Software Metering Services for Windows applications.
  139.  
  140. o    Works well in conjunction with our DOS-based product, DOSmenu.
  141.                               MISCELLANEOUS
  142. ══════════════════════════════════════════════════════════════════════════════
  143.  
  144. Requirements
  145. ────────────
  146. WOmenu's only additional requirement is that it needs the Visual Basic 3.0
  147. runtime library, VBRUN300.DLL, in order to run.  If you do not have this file
  148. yet, it may be downloaded from almost any on-line service.  We can also
  149. provide you with this program, if required.
  150.  
  151. Startup Options
  152. ───────────────
  153. WOmenu is normally started by specifying the program file as the Windows
  154. shell.  The first line in your SYSTEM.INI should read
  155.  
  156.      shell=[path]womenu.exe
  157.  
  158. However, it may be started directly from within Windows.  In this case, the
  159. command should be
  160.  
  161.      [path]womenu.exe
  162.  
  163. Here, quitting WOmenu will not quit Windows.
  164.  
  165. Required Files
  166. ──────────────
  167. The following files are necessary to run WOmenu:
  168.  
  169. WOMENU.EXE     The WOmenu program.
  170.  
  171. WOMENU.INI     The WOmenu INI (menu) file (see WOMENU INI FILE section below).
  172.  
  173. THREED.VBX     A Visual Basic library file for WOmenu.
  174.  
  175. CMDIALOG.VBX   Another Visual Basic library file for WOmenu.
  176.  
  177. VBRUN300.DLL   The main Visual Basic runtime library.
  178.  
  179. Optional Files
  180. ──────────────
  181. WOMENUUH.INI   The optional administrator-defined main user help screen (see
  182.                USER HELP INI FILE section below).
  183.  
  184. WOMENU.LOG     (You choose name) If logging is enabled, this file is appended
  185.                every time a user performs a menu action.  Included statistics
  186.                are:  user name, node address, server name, date, time, and
  187.                menu action.
  188.  
  189. WOMENU.MTR     (You choose name) If metering is enabled, this is the central
  190.                file where the metering information is kept.
  191.  
  192. WOCALC.EXE     A calculator utility that works with the keyboard as well as a
  193.                mouse (registered version only).
  194.  
  195. WOCAL.EXE      A calendar utility that easily works with the keyboard as well
  196.                as a mouse (registered version only).
  197.  
  198. WOVIEW.EXE     A file viewer with a simple interface that works with the
  199.                keyboard as well as a mouse (registered version only).
  200.  
  201. WOMETER.EXE    A Windows real-time Meter Viewer/Reset utility.
  202.                                QUICK START
  203. ══════════════════════════════════════════════════════════════════════════════
  204.  
  205. To quickly get the menu system up and running, do the following (check the
  206. documentation later for specifics):
  207.  
  208. o    Copy all WOmenu files to your Windows directory.  This directory is
  209.      normally C:\WINDOWS on a stand-alone system and F:\WINDOWS on a network
  210.      system.  To use WOmenu for all of your users, copy it to the Windows
  211.      network directory.
  212.      WOMENU.EXE
  213.      WOMETER.EXE
  214.      CMDIALOG.VBX
  215.      THREED.VBX
  216.     (VBRUN300.DLL must also be in the \WINDOWS or \WINDOWS\SYSTEM directory)
  217.  
  218. o    If not already running Windows, run it.
  219.  
  220. o    Run 'WOMENU.EXE' from the Windows directory.  This first run will make a
  221.      default WOMENU.INI file in the same Windows directory.
  222.  
  223. That's all there is to it.  You now have an operating menu system.  You may
  224. use WOmenu to change your menu items and sub-menus as you desire.  After you
  225. get the menu the way you want it (especially if you administer a network) you
  226. will want to change some of the default setup options in the INI file and add
  227. appropriate rights to the menu item lines so as to lock your users and protect
  228. your network.  See the WOMENU INI FILE below for help in this area.
  229.  
  230. If you plan to run in a network multi-user environment, then check these
  231. sections out also:  DOS PROGRAM PIF FILES and USERS WINDOWS ENVIRONMENT.
  232.                                  COMMANDS
  233. ══════════════════════════════════════════════════════════════════════════════
  234.  
  235. EDIT      Allows editing of the highlighted menu item or sub-menu item.  Edit
  236.           fills in all parts of a menu item or sub-menu item except for the
  237.           item's menu rights.  See MENU RIGHTS section below.  This command is
  238.           not available in multi-user mode.
  239.  
  240. MOVE      Allows moving of the highlighted menu item or sub-menu item within
  241.           the same menu.  This command is not available in multi-user mode.
  242.  
  243. INSERT    Allows the insertion of a new menu item or sub-menu item.  This
  244.           command is not available in multi-user mode.
  245.  
  246. DELETE    Allows the deletion of the highlighted menu item or sub-menu item.
  247.           This command is not available in multi-user mode.
  248.  
  249. HELP      Brings up a context sensitive help screen.
  250.  
  251. QUIT      Quits the menu system.  If it was used as the Windows Shell, it will
  252.           first check that all programs have been quit and then it will quit
  253.           Windows as well.
  254.  
  255. F5        Refreshes (rereads) the INI file and repaints the menu form.
  256.  
  257. Ctrl-F5   Toggles the Multi-User mode.  This command can be password-
  258.           protected.  It is useful when the system is in Multi-User mode and
  259.           the administrator needs to change it.
  260.                              WOMENU INI FILE
  261. ══════════════════════════════════════════════════════════════════════════════
  262.  
  263. WOmenu has one setup file, the INI file (which is the actual menu file).  This
  264. section explains the INI file specifics.
  265.  
  266. SETUP
  267. ═════
  268.  
  269. [Windows Office Menu Setup]
  270. ───────────────────────────
  271. This section deals with setup specifics.  The actual menus are kept in the
  272. remaining sections of the INI file.
  273.  
  274. Multi-User=
  275. ───────────
  276. Default:  no.  This is the switch that determines whether WOmenu operates as a
  277. simple editable menu system for single users or as an overall system where
  278. editing is not allowed and all menu items can be determined through menu
  279. rights.
  280.  
  281. AdminPassword=
  282. ──────────────
  283. Default:  {nothing}.  Place a password here to inhibit the Ctrl-F5 Multi-User
  284. toggle, which is useful for the administrator to have access to changing the
  285. menu even if it is in Multi-User mode.
  286.  
  287. MainMenuTitle=
  288. ──────────────
  289. Default:  Windows Office Menu.  This determines which section WOmenu uses to
  290. define its first menu screen.
  291.  
  292. UserVar=
  293. ────────
  294. Default:  {nothing}.  This is the DOS variable name (set in the login script)
  295. that holds the user login name, like UserVar=userid.  It is only required if
  296. you plan to use the User right (see MENU RIGHTS section below).  See DOS
  297. ENVIRONMENT VARIABLES section below for how to define this variable.
  298.  
  299. ServerVar=
  300. ──────────
  301. Default:  {nothing}.  This is the DOS variable name (set in the login script)
  302. that holds the active server name, like ServerVar=servername.  It is only
  303. required if you plan to use the Server right (see MENU RIGHTS section below).
  304. See DOS ENVIRONMENT VARIABLES section below for how to define this variable.
  305.  
  306. NodeVar=
  307. ────────
  308. Default:  {nothing}.  This is the DOS variable name (set in the login script)
  309. that holds the user workstation address, like NodeVar=nodeaddr.  It is only
  310. required if you plan to use the Node right (see MENU RIGHTS) section below).
  311. See DOS ENVIRONMENT VARIABLES section below for how to define this variable.
  312.  
  313. DoLog=
  314. ──────
  315. Default:  no.  Enter 'yes' here to turn on user activity logging.
  316.  
  317. LogFile=
  318. ────────
  319. Default:  {nothing}.  Enter the name of the log file to use here, like
  320. LogFile=f:\share\womenu.log.  Users must have 'write' access to this file in
  321. order for logging to work on a network.  The log function logs menu start,
  322. menu end, and all program starts.  The user's login name (if defined), server
  323. (if defined), node address (if defined), date, and time name are all entered
  324. into the log file.  You may wish to periodically erase or archive this file
  325. because it can get quite large after a while if you have many users.
  326.  
  327. DoMeter=
  328. ────────
  329. Default:  no.  Enter 'yes' here to turn on software metering.
  330.  
  331. MeterFile=
  332. ──────────
  333. Default:  {nothing}.  Enter the name of the meter file to use here, like
  334. MeterFile=f:\share\womenu.mtr.  Users must have 'write' and 'erase' access to
  335. this file in order for metering to work on a network.  See SOFTWARE METERING
  336. SERVICE section below for specifics on software metering.
  337.  
  338. MaxRunning=
  339. ───────────
  340. Default:  0.  The optional maximum number of items the users can run at one
  341. time.  Enter 0 for no limits.  Use this function if you wish to restrict how
  342. many programs can be run at once, perhaps for memory reasons.
  343.  
  344. Note=
  345. ─────
  346. Default:  Welcome to Windows Office Menu.  Enter a note here (of approximately
  347. 120-140 characters maximum) if you want your users to see one when they first
  348. start the menu system.  After the first user sees this note, a hidden date
  349. will be appended to the end of it so WOmenu can figure how to not show it on
  350. the following days.  That way you do not have to remember to delete the note.
  351. If you enter a note the night before and then view it by running WOmenu, be
  352. sure to go into the WOMENU.INI file afterwards and change the date at the end
  353. of the note to the next day.  If you wish to show a note for several days,
  354. enter a date in the future.  The format is like:
  355.  
  356. Note=note text.|||DD-MM
  357.  
  358.  
  359. MENUS
  360. ═════
  361.  
  362. [sub-menu titles]
  363. ─────────────────
  364. These section headings define the sub-menus used in the menu system.  The
  365. first one is [Windows Office Menu] by default.
  366.  
  367. Pgm#= {Pgm1, Pgm2, Pgm3, etc. up to the maximum of 20 per section}
  368. ─────
  369. These entries hold all information for each menu item or sub-menu item.  The
  370. numbers define only the order of items on the menu.  In Multi-User mode, only
  371. the items that pass the 'rights' tests will be actually be shown.
  372.  
  373. The information is separated by commas, so do not use commas in your
  374. descriptions.  Here are the sections:
  375.  
  376. Title, Wintitle, Description, Program, Workdir, Rights
  377.  
  378. Title
  379. ─────
  380. The item's button text, like '&WordPerfect'.  Use the & character to
  381. underscore a letter for a hotkey, if desired.
  382.  
  383. Wintitle
  384. ────────
  385. IMPORTANT:  The actual name of the program's Windows title.  You may have to
  386. run a program it check this one time.  Do not add any dynamically appended
  387. text here.  For instance, Notepad's Windows title in version 3.1 is 'Notepad'.
  388. But after loading a program, it becomes 'Notepad - [filename]'.  Make sure
  389. only to add the 'Notepad' part here.  Case is not significant.  Another
  390. example:  for Winword, use 'Microsoft Word'.  For PIF files, you will decide
  391. yourself what that Windows title will be -- just place it here as well.
  392.  
  393. Description
  394. ───────────
  395. The item's optional description text, like 'A word processor'.
  396.  
  397. Program
  398. ───────
  399. The item's executable call to Windows and/or DOS, like 'f:\apps\wp\wp.exe'.
  400. This could be a PIF file or batch file as well.
  401.  
  402. Workdir
  403. ───────
  404. The item's optional work directory, like 'h:\'.
  405.  
  406. Rights
  407. ──────
  408. The item's optional rights to determine whether the user will get this item on
  409. their menu, like '{d=f:\apps\wp}'.  See the MENU RIGHTS section for specifics
  410. on this powerful feature.
  411.  
  412.  
  413. SUB-MENU TITLES
  414. ═══════════════
  415.  
  416. Sub-menu titles are annotated slightly differently than normal menu items for
  417. program.  Where '&WordPerfect' may define a menu item, '< &Word Processing >'
  418. would define a sub-menu (and subsequent new section '[Word Processing]').
  419. WOmenu takes care of this for you, but if you decide to edit your menu file
  420. manually, take this into consideration.
  421.  
  422.  
  423. NOTES
  424. ═════
  425.  
  426. Not all sections must be filled out.  Although the title and program section
  427. is always required for a menu item, only the title section is required for a
  428. sub-menu item.  Just be sure that commas remain to identify which section text
  429. belongs to, like:
  430.  
  431. ;─────
  432. Pgm1=&Lotus 1-2-3,LOTUS 1-2-3,,123
  433. ;─────
  434. This is enough to run 123 if it exists and can be found in the path.
  435.                               USER HELP INI FILE
  436. ══════════════════════════════════════════════════════════════════════════════
  437.  
  438. The administrator can opt to have a home-grown main help screen (the one that
  439. appears when the user presses F1 at a menu or sub-menu screen).
  440.  
  441. WOmenu creates a file called WOMENUUH.INI (UH is for User Help) in its
  442. directory the forst time it is run.  This INI file is a shell that allows
  443. input of up to 14 help lines of 48 characters or less each.
  444.  
  445. When a user presses F1 for help at a menu screen, WOmenu checks to see if at
  446. least the first or second line of this file (1= or 2=) is filled out.  If so,
  447. then this data is used to fill in the help screen.  If not, the normal
  448. built-in help screen is shown.
  449.                                MENU RIGHTS
  450. ══════════════════════════════════════════════════════════════════════════════
  451.  
  452. A powerful means of segregating the menu file between users is by applying the
  453. 'rights' feature in Multi-User mode.  We can decide what items should actually
  454. appear on a user's menu by defining certain rights for some or all of the
  455. items listed in the INI file.  You must manually add these rights into the
  456. menu file, preferably after you have made it the way you want it to be with
  457. the Edit, Move, Insert, and Delete commands.  Let's discuss each right.
  458.  
  459. All rights assumed
  460. ─────────────────-
  461. Right = no rights entered.  This method is the quickest and least secure way
  462. of checking users rights because it checks nothing.  In other words, a menu
  463. item will show up on a user's menu, period.  Here, you will be relying on your
  464. defined network rights to determine whether a user will be able to _run_ an
  465. item or not (they will see them on their menu).
  466.  
  467. ;─────
  468. Pgm1=&Notepad, NOTEPAD, Windows Notepad, notepad, h:\,
  469. ;─────
  470. User gets item if it is available, period, because the final section is empty.
  471.  
  472.  
  473. Directory rights
  474. ────────────────
  475. Right = {d=directory name or d=directory name1,directory name2 ..}.  WOmenu
  476. will look to see if any of the listed directories exist when it reads the menu
  477. file, and if none of them do, it will not place the item on the user's menu.
  478.  
  479. ;─────
  480. Pgm1=&Notepad, NOTEPAD, Windows Notepad, notepad, h:\, {d=f:\apps\editor}
  481. ;─────
  482. User gets item only if F:\APPS\EDITOR is 'visible' in the user's environment.
  483.  
  484.  
  485. File rights
  486. ───────────
  487. Right = {f=file name or f=file name1,file name2 ..}.  WOmenu will look to see
  488. if any of the listed files exist for the user when it reads the menu file, and
  489. if none of them do, it will not place the item on the user's menu.
  490.  
  491. ;─────
  492. Pgm1=&Notepad, NOTEPAD, Win Notepad, notepad, h:\, {f=f:\windows\notepad.exe}
  493. ;─────
  494. User gets item only if F:\WINDOWS\NOTEPAD.EXE is 'visible' in the user's
  495. environment.
  496.  
  497.  
  498. User rights (uses UserVar definition)
  499. ───────────
  500. Right = {u=user_id or u=user_id1,user_id2 ..}.  This method takes the
  501. discrimination down to the actual user id running the system.  If the user
  502. name is in the list, then the user gets the item on their menu (if any other
  503. specified rights are also approved).
  504.  
  505. ;─────
  506. Pgm1=&Notepad, NOTEPAD, Windows Notepad, notepad, h:\, {u=joeb}
  507. ;─────
  508. User gets item only if his user logon ID is JOEB.
  509.  
  510.  
  511. Server rights (uses ServerVar definition)
  512. ─────────────
  513. Right = {s=server_name1 or s=server_name1,server_name2 ..}.  Here, by placing
  514. one or more server names with a menu item, you are saying only show this item
  515. when the user is logged into one of those servers.
  516.  
  517. ;─────
  518. Pgm1=&Notepad, NOTEPAD, Windows Notepad, notepad, h:\, {s=main_server}
  519. ;─────
  520. User gets item only if the user is logged into and running on MAIN_SERVER.
  521.  
  522.  
  523. Node rights (uses NodeVar definition)
  524. ───────────
  525. Right = {n=node_address or n=node_address1, node_address2 ..}.  This method
  526. takes the discrimination down to the actual user's workstation.  If the node
  527. address is the same as that of the workstation, then the user gets the item
  528. on their menu (if any other specified rights are also approved).
  529.  
  530. ;─────
  531. Pgm1=&Notepad, NOTEPAD, Windows Notepad, notepad, h:\, {n=fa164505}
  532. ;─────
  533. User gets item only if his work station's address is FA164505.
  534.  
  535.  
  536. Environment rights
  537. ──────────────────
  538. Right = {e=dos_env_var~env_var_text, ..}.  This right tests for the contents
  539. of a DOS variable.  For instance, to run a menu item depending on what room a
  540. person is in, set ROOM=room_number at login; then enter this right for the
  541. menu item in the menu file:  {e=room~102}  to test for room 102.
  542.  
  543. ;─────
  544. Pgm1=&Notepad, NOTEPAD, Windows Notepad, notepad, h:\, {e=room~102}
  545. ;─────
  546.  
  547.  
  548. Software metering rights (not really a 'right')
  549. ────────────────────────
  550. Right = {m=command[:number]}.  Entering this rule on an item's right line will
  551. force the command for the item to be metered, if metering is turned on and the
  552. meter file has been defined (within WOMENU.INI).  Please see the SOFTWARE
  553. METERING SERVICE section for a complete discussion of this capability.
  554.  
  555. ;─────
  556. Pgm1=&Word,MICROSOFT WORD,Microsoft Word,winword.exe,h:\,{m=winword:25}
  557. ;─────
  558. This item will run as long as less than 25 other users are running it.
  559.  
  560.  
  561. Password rights (not really a 'right')
  562. ───────────────
  563. Right = {p=password where password is any alphanumeric, non-case sensitive,
  564. phrase}.  Placing a password on a menu item means that when the user selects
  565. this item, the user will be prompted for the correct password.
  566.  
  567. ;─────
  568. Pgm1=&Notepad, NOTEPAD, Windows Notepad, notepad, h:\, {p=restrict}
  569. ;─────
  570. User gets item only if he or she can answer the password prompt with RESTRICT.
  571.  
  572.  
  573. Question rights (not really a 'right')
  574. ───────────────
  575. Right = {q=your question that demands a yes/no answer?}  This method simply
  576. pops up a question and asks for a Yes or No answer.  If no, it will not run.
  577.  
  578. ;─────
  579. Pgm1=&Notepad, NOTEPAD, Windows Notepad, notepad, h:\, {q=Are you sure?}
  580. ;─────
  581. Will only run if the user answers Yes.
  582.  
  583.  
  584. Group rights (how to 'fake' this right)
  585. ────────────
  586. Right = no such right; use directory rights instead.  WOmenu was built to be
  587. generic as far as networks are concerned.  Therefore, the networks 'groups'
  588. are not used.  Instead, we suggest (and use ourselves) a method that actually
  589. invokes the directory right method.
  590.  
  591. Let's say you only want users who are a member of group WP or a member of
  592. group WORD_PROCESS to be able to run WordPerfect.  Within SYSCON or NETCON
  593. (for NetWare networks), you should give each of these groups a trustee
  594. right assignment to a directory called, let's say, F:\FLAGS\WP.  Read/file
  595. scan is enough to 'see' the directory.
  596.  
  597. Then, in the user's INI (menu) file, define the following right:
  598.  
  599. Pgm1=&WordPerfect, WORDPERFECT FOR WINDOWS, A wordprocessor, ...
  600.      ... f:\apps\wp\wp, h:\, {d=f:\flags\wp}
  601.  
  602. which in effect will perform the same function as checking for a member of a
  603. group, because only those users who _are_ a member of one of the above sample
  604. groups will be able to see this directory.
  605.  
  606.  
  607. NOTES
  608. ═════
  609.  
  610. More than one of the above methods may be used at one time, either within the
  611. same right grouping or by having two or more groupings.  For example, you can
  612. place both a server (s=) and a group (u=) method on the same menu item, like:
  613.  
  614. ;─────
  615. Pgm1=&Notepad, NOTEPAD, Windows Notepad, notepad, {u=joeb}{s=server1}
  616. ;─────
  617. Here, it is read as user joeb _AND_ on server1.
  618.  
  619. or by using the OR ';' such as
  620.  
  621. ;─────
  622. Pgm1=&Notepad, NOTEPAD, Windows Notepad, notepad, {u=joeb;s=server1}
  623. ;─────
  624. Here, it is read as user joeb _OR_ on server1.
  625.  
  626. Note that when using more than one grouping {}, each of the groupings must be
  627. true for the item to be shown (they are ANDed).  When using one or more
  628. methods within the same group, they are ORed.
  629.  
  630. Placing a '!' before a name means 'not'.  Where {u=joeb} means if the current
  631. user is joeb, then display the menu item; {u=!joeb} means display the item
  632. only if the current user is NOT joeb.
  633.  
  634. The biggest rule that you must remember about the rights methods are that
  635. within each set of braces {}, the answer must be true.  So if you use more
  636. than one set of braces for a menu item, they all must be true.  For example:
  637.  
  638. ;─────
  639. Pgm1=&Notepad, NOTEPAD, Windows Notepad, notepad, ...
  640.      ... {d=f:\apps\wp}{u=joe,jim;n=fa164505}{s=!server2}
  641. ;─────
  642. will only show if the user can 'see' directory F\APPS\WP _AND_ the user is JOE
  643. _OR_ JIM _OR_ the node address is FA164505 _AND_ the user is not on SERVER2.
  644.                         USERS WINDOWS ENVIRONMENT
  645. ══════════════════════════════════════════════════════════════════════════════
  646.  
  647. The WOmenu system can make your users' Windows environment a simple one that
  648. is very easy to maintain.  We'll explain our setup as an example.
  649.  
  650. o    We set up Windows as a network install in F:\WINDOWS.  We ran one user
  651.      SETUP from the Windows directory to get the default WIN.INI and
  652.      SYSTEM.INI files.  We changed the shell defined in SYSTEM.INI to
  653.      WOMENU.EXE.  Then we copied the necessary files to our own SETUP
  654.      directory under F:\WINDOWS.  These files, surprisingly enough, consisted
  655.      of only the following files:
  656.  
  657.      WIN.COM
  658.      WIN.INI
  659.      SYSTEM.INI
  660.  
  661.      Note that no Program Manager files are needed at all.
  662.  
  663. o    For each DOS program our users may run through their menu definitions, we
  664.      defined a PIF file.  Our defined items in the INI (menu) file point to
  665.      these PIF files on the Pgm#= lines.
  666.  
  667. o    To set up a user, we add them to a WINDOWS group in Syscon, make a
  668.      directory under their private directory called WINDOWS, and copy the
  669.      above listed files into that directory.
  670.  
  671. o    Our users run mostly DOS PIF-defined programs and have no need for a
  672.      mouse.  WOmenu runs and handles nicely without one.
  673.  
  674. That's all there is to it.  Easy and quick to add/delete users from the menu
  675. setup.   And we have security while providing our users with multi-tasking.
  676.                         DOS ENVIRONMENT VARIABLES
  677. ══════════════════════════════════════════════════════════════════════════════
  678.  
  679. WOmenu uses up to three DOS variables to tell the system about your
  680. environment; user ID, server name and workstation node address.
  681.  
  682. In the case of NetWare, you define and load this DOS variable once during the
  683. user login script with the correct information.
  684.  
  685.      DOS SET USERID="%LOGIN_NAME"
  686.  
  687. where userid can be called anything you wish.  You could then add this name
  688. to various rights as desired.  Womenu takes care of the rest.
  689.  
  690. If you plan on using server name rights, then you would set up the server name
  691. variable in a similar manner.  For NetWare,
  692.  
  693.      DOS SET SERVER="%FILE_SERVER"
  694.  
  695. place the above line in the users login script.
  696.  
  697. The node address variable is needed if you intend to restrict any menu items
  698. by comparing a work station's node address.  In a Novell network, you could
  699. define this variable like:
  700.  
  701.      DOS SET _NODE="%P_STATION"<<4
  702.  
  703. where the <<4 takes the first 4 numbers away from the actual twelve digit
  704. address.
  705.                           DOS PROGRAM PIF FILES
  706. ══════════════════════════════════════════════════════════════════════════════
  707.  
  708. When placing DOS programs on a user's menu system, through their INI (menu)
  709. file, there are a few cautions and guidelines we have learned and would like
  710. to pass on to you.  they are all optional but make a lot of sense toward
  711. keeping the menu usable and secure.
  712.  
  713. o    Make sure the entry for the "Window Title" is the same as the entry you
  714.      will place in the INI file on the Pgm#= line.  In this way, WOmenu will
  715.      easily be able to find this program's DOS window when trying to determine
  716.      if the user has already run the program once or not.  (WOmenu attempts to
  717.      allow users only one run of each program on their menu.)
  718.  
  719. o    Recommend setting the option "Full Screen" to on.
  720.  
  721. o    Recommend setting the option "Background" to on.
  722.  
  723. o    Recommend locking out all "Shortcut Keys" except Alt-Tab (which is needed
  724.      to switch between programs and back to the menu window).
  725.  
  726.                         SOFTWARE METERING SERVICE
  727. ══════════════════════════════════════════════════════════════════════════════
  728.  
  729. WOmenu includes a powerful capability called software metering which enables
  730. you to control the number of simultaneous run instances of an application.
  731. For instance, if you have bought 25 licenses for Microsoft Word, you now have
  732. the means to insure that only 25 copies are run at one time from with the menu
  733. system on your network.
  734.  
  735. There are more expensive and perhaps more foolproof offerings on the market
  736. for this service, but WOmenu does the job simply and easily.  And we believe
  737. that an administrator's effort level in attempting to control software
  738. licensing is at least 95% of any large distributor's concerns.
  739.  
  740. Here is how you set up metering:
  741.  
  742. 1.  Place these commands in WOMENU.INI under [Windows Office Menu Setup]:
  743.  
  744. DoMeter=yes
  745. MeterFile=f:\share\womenu.mtr (or something like that)
  746.  
  747. Users must have WRITE and ERASE rights to the above area.
  748.  
  749. 2.  Place the meter right on those commands you want metered, for example:
  750.  
  751. ;─────
  752. Pgm1=&Word,MICROSOFT WORD,Windows word processing, ...
  753.      ... f:\apps\word\winword.exe,h:\,{m=word:25}
  754. ;─────
  755.  
  756. will meter the use of F:\APPS\WORD\WINWORD.EXE for all accesses from WOmenu.
  757. If 25 instances are already in use (in this example), then WOmenu will
  758. instruct the user that the maximum licenses are in use and to try again later.
  759.  
  760. The syntax is important.  The application keyword, in this case WORD, may be
  761. 10 or less characters with no spaces, followed by an immediate colon ':',
  762. followed by an immediate number from 1 to 999 (with no spaces) -or- if no
  763. :number is entered, then 999 is assumed (good for counting accesses only).
  764.  
  765. These both work:
  766. {m=word:25} ;limit 25
  767. {m=word}    ;no limit
  768.  
  769. Of course anyone accessing WINWORD.EXE from outside of the menu system will
  770. not be metered in this way.  See the WOMETER METERING UTILITY section to find
  771. out how to meter DOS software runs from outside the menu system.  Also, if you
  772. call the application from more than one menu item in your menu file, make sure
  773. you place the same meter rights for each item.
  774.  
  775. Note: RECOMMEND DELETING THE METER FILE PERIODICALLY/NIGHTLY...
  776. If any user locks up while in a metered application, or gets rebooted at that
  777. point, then the meter count for that app will remain off by one (it will show
  778. one greater than actual).  For this reason, we recommend deleting the defined
  779. meter file periodically, perhaps at night before or after your backup.  See
  780. WOMETER WINDOWS METERING UTILITY section for how to do this automatically.
  781.  
  782. Be careful when viewing your meter file.  The recommended way to view it is
  783. with WOmeter (see below).
  784.                     WOMETER WINDOWS METERING UTILITY
  785. ══════════════════════════════════════════════════════════════════════════════
  786.  
  787. This utility can optionally monitor your software usage from outside of the
  788. menu system but from within Windows.  All of your users' programs can be
  789. reliably monitored for metering.
  790.  
  791. There are no command line parameters; just run:
  792.  
  793.      WOMETER
  794.  
  795. WOMETER.EXE will attempt to find the meter file's name in its WOMETER.INI
  796. file.  If it does not, it will make this file in its home directory and then
  797. you can fill in the name of the meter file, like:
  798.  
  799. [Setup]
  800. MeterFile=c:\windows\womenu.mtr (or something like that)
  801.  
  802. WOmeter allows real-time reseting of specific metered applications, in case
  803. the count has gone astray (perhaps from user lockups, etc.).
  804.  
  805. You may also set up WOmeter to automatically erase your meter file on a daily
  806. basis at a specified time.  The default is 00:01 (one minute after midnight).
  807.  
  808. You may also define the length of time WOmeter waits between re-reads of the
  809. meter file (between 10 and 60 seconds).
  810.  
  811. If you also use our DOS-based menu product, DOSmenu, WOmenu can easily work
  812. in concert with it for both meter files and log files.  Simply point the name
  813. and location of these files to the same files delineated in the DOSmenu INI
  814. file.  Then you will have a complete picture of your user activities on your
  815. network.
  816.                            DOSMENU MENU SYSTEM
  817. ══════════════════════════════════════════════════════════════════════════════
  818.  
  819. We have another product called DOSmenu that is a network menuing system as
  820. well.  However, DOSmenu works from DOS.  It is a very popular product that
  821. can work nicely in conjunction with WOmenu.  If you are interested in this
  822. product, please contact us.  If you wish to try it first, it is available from
  823. Compuserve in the shareware form.  Look on the Internet with Anonymous FTP:
  824. ftp://io.com:/pub/usr/zboray/shareware directory.
  825.  
  826.                                 SHAREWARE
  827. ══════════════════════════════════════════════════════════════════════════════
  828.  
  829. Evaluation Copy
  830. ───────────────
  831. THIS IS NOT FREE SOFTWARE!  You may evaluate and use this product, but if you
  832. decide to make use of it on a regular basis, you must register your copy.
  833.  
  834. Note:  Businesses, government agencies and institutions are required to
  835. register this software package before extended use.
  836.  
  837. We offer several inducements to you for registering.  First of all, you will
  838. receive the most up-to-date copy of the program -- and we update the program
  839. on a regular basis.  Second, we have additional mini-utilities that work
  840. nicely with WOmenu not included in this package that we will ship to you upon
  841. registration.  Third, you will never see the shareware message again.  Make no
  842. mistake, however -- this is a fully functional version of WOmenu that is not
  843. "crippled" in any way.
  844.  
  845. Distribution
  846. ────────────
  847. This is "user-supported" software.  You are hereby granted permission to
  848. distribute this evaluation copy of WOmenu and its documentation, subject to
  849. the following conditions:
  850.  
  851. 1.  Shareware WOmenu may be distributed freely without charge in evaluation
  852.     form only.  The original PKZIP, WOMENU25.ZIP, is the preferred method.
  853.  
  854. 2.  WOmenu in its shareware form may not be sold, licensed, or a fee charged
  855.     for its use.  If a fee is charged in connection with WOmenu, it must cover
  856.     the cost of copying or dissemination only.  Such charges must be clearly
  857.     identified as such by the originating party.  Under no circumstances may
  858.     the purchaser be given the impression that he is buying a registered
  859.     version of WOmenu.
  860.  
  861. 3.  Shareware WOmenu must be presented as a complete unit with documentation.
  862.     Neither WOmenu nor its documentation may be amended or altered in any way
  863.     without permission of the copyright holder.
  864.  
  865. 4.  By granting you the right to distribute the evaluation form of WOmenu, you
  866.     do not become the owner of WOmenu in any form.
  867.  
  868. Any other use, distribution or representation of WOmenu is expressly forbidden
  869. without written consent from the copyright holder.
  870.  
  871. Registration
  872. ────────────
  873. The non-commercial single-user registration fee for WOmenu is $35.00 US.
  874. ($10 shipping is included.)
  875.  
  876. The commercial/government and multi-system site fee for WOmenu is:
  877.  
  878.      Non-network environment:
  879.           Per machine        -  $35.00 US.
  880.      Network environment:
  881.           Per server         - $160.00 US.
  882. ($10 shipping is included.)
  883.  
  884. Send a check, money order or company P.O. for the appropriate amount to:
  885.  
  886.           Bremer Corporation -WOmenu
  887.           5114 Balcones Woods Drive, #307-372
  888.           Austin, Texas 78759
  889.  
  890. We also accept Mastercard, Visa, American Express and Corporate American
  891. Express telephone orders.
  892.  
  893. Thank you.
  894.  
  895. Telephone: 512-328-2465             INTERNET E-mail:   zboray@io.com
  896.                                     CompuServe ID:     71614,2556
  897.  
  898. See WOORDER.DOC for a ready-made ordering form.
  899.  
  900. Disclaimer
  901. ──────────
  902. The author does not warrant that the functions contained in this program will
  903. meet your requirements or that the program operation will be uninterrupted or
  904. error free.
  905.  
  906. The author specifically disclaims all other warranties, expressed or implied,
  907. including but not limited to implied warranties of fitness for any particular
  908. purpose and of merchantability.
  909.  
  910. In no event will the author be liable to you for any damages, including but
  911. not limited to any lost profits, lost savings, commercial damage or other
  912. incidental or consequential damages arising out of the use or inability to use
  913. this program, or for any claim by any other party.
  914.  
  915. Trademarks
  916. ──────────
  917. Trademarks of companies or products mentioned in WOmenu documentation files
  918. are the property of their respective companies.
  919.